Jobs · Get or poll a job
Poll a job created by adding async=true, or the header Prefer: respond-async, to any GET /v1 request. A queued job has not been charged. A finished job's result is the operation body, charged once through the normal ledger. Failed, empty, expired and cancelled jobs cost 0.
Credit Cost & Caching
View credit packs ↗Default: 0 credits
An empty result costs 0 credits.
How charges are determined
Cost is decided per call, not per endpoint: the same operation can cost different amounts depending on what it returns.
A call that fails costs 0 credits. A result served from cache costs 0 credits.
`default` is the cost when no rule matches. Rules are evaluated in order and the first whose conditions all hold wins.
A `when` condition is one of: `param` (the request parameter is true), `outcome` (the classifier's outcome), `empty` / `nonEmpty` (a response field is empty and absent, or a non-empty array or string), `flag` (a response field is exactly true).
A cost of `{ perStartedMinute: n, of: [fields] }` is n x max(1, ceil(seconds / 60)), so even a short result bills at least one minute.
Cache control
Not specified in the published contract.
Pagination
Check cursor / page parameters and response fields below.
Authorizations · Headers
Your Fetchproof API key (starts with fp_live_). Create one at app.fetchproof.com.
Path & Query Parameters
1 parameterJob id from the 202 response. Pass that id and nothing else.
Response Schemas
200Job state. Reading or cancelling a job costs 0 credits.
application/jsonqueuedrunningsucceededfailedexpiredcancelledThe finished operation body, present once the job has ended.